서브에이전트는 Claude Code가 작업을 위임할 수 있는 전문화된 보조 도구입니다. 각각이 자신만의 대화 컨텍스트 창에서 실행되며, 맡은 작업을 수행한 뒤 메인 스레드에 요약 결과를 반환하는 집중된 도우미라고 생각하면 됩니다. 파일 읽기, 검색, 도구 호출 등 중간 단계는 모두 격리된 채로 유지되어 메인 대화를 어지럽히지 않습니다.

서브에이전트가 중요한 이유

Claude Code와 대화할 때마다 메인 컨텍스트 창에 내용이 쌓입니다. 모든 도구 호출, 파일 읽기, 검색 결과가 그곳에 저장됩니다. 이 공간은 유한하며, 가득 차면 Claude는 대화의 초반부를 놓치기 시작합니다.

서브에이전트는 별도의 컨텍스트 창을 생성하여 이 문제를 해결합니다. 서브에이전트는 두 가지를 전달받습니다:

• 커스텀 시스템 프롬프트 -- 서브에이전트의 역할과 동작을 정의하는 설정 파일에서 제공됩니다
• 작업 설명 -- 사용자의 요청을 바탕으로 상위 에이전트가 작성합니다

서브에이전트는 이후 독립적으로 작동합니다. 파일을 읽고, 검색을 실행하고, 코드를 편집하는 등 필요한 모든 작업을 수행합니다. 작업이 완료되면 요약본만 메인 대화로 돌아오고, 서브에이전트의 전체 대화 내용은 삭제됩니다.

이를 통해 메인 컨텍스트가 깔끔하게 유지됩니다. 답을 찾는 과정의 잡음 없이 결과만 받을 수 있습니다. 단, 서브에이전트가 결론에 도달한 과정을 직접 확인할 수 없다는 트레이드오프가 있습니다.

실용적인 예시

낯선 코드베이스를 탐색하면서 어떤 서비스가 환불을 처리하는지 알고 싶다고 가정해 봅시다. 서브에이전트 없이는 Claude가 15개의 파일을 읽고, 여러 번 검색하고, 여러 함수 호출을 추적할 수 있습니다. 단 하나의 사실만 필요했더라도 이 모든 것이 컨텍스트 창을 채웁니다.

서브에이전트를 사용하면 훨씬 깔끔한 경험을 할 수 있습니다. 질문을 하면 Explore 서브에이전트가 실행되어 자체 컨텍스트에서 모든 탐색 작업을 수행하고, 핵심 답변만 돌려줍니다.

메인 컨텍스트 창에는 질문과 요약만 기록되며, 중간에 읽은 15개의 파일은 포함되지 않습니다.

기본 제공 서브에이전트

Claude Code에는 즉시 사용할 수 있는 여러 기본 서브에이전트가 포함되어 있습니다:

• 범용 서브에이전트 -- 탐색과 실행이 모두 필요한 다단계 작업에 활용
• Explore -- 코드베이스의 빠른 검색 및 탐색에 활용
• Plan -- 계획을 제시하기 전에 코드베이스를 조사하고 분석하는 플랜 모드에서 활용

커스텀 서브에이전트

기본 제공 옵션 외에도 커스텀 시스템 프롬프트와 도구 접근 권한을 갖춘 나만의 서브에이전트를 만들 수 있습니다. 코드 리뷰어, 테스트 작성자, 문서 생성기 등 워크플로에 맞는 전문화된 에이전트를 자유롭게 정의할 수 있습니다.

핵심 정리

서브에이전트는 세 가지 주요 이점을 제공합니다:

• 작업을 집중적인 단위로 분리하여 각 서브에이전트가 특정 작업에 집중할 수 있게 합니다
• 모든 중간 작업을 격리하여 메인 컨텍스트 창을 깔끔하게 유지합니다
• 필요한 정보만 간결한 요약으로 반환합니다

기본 제공 서브에이전트를 활용하든 직접 만들든, 서브에이전트는 더 긴 Claude Code 세션을 더욱 효과적으로 활용하는 실용적인 방법입니다. 메인 컨텍스트의 잡음이 적을수록 더 오래, 더 효과적으로 작업할 수 있습니다.